__________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________
**********************************************************************************************************************************
**********************************************************************************************************************************


  README for ARMA2 Arresting gear script.


*********************************
*********************************


  Version:  1.02
   November 2009 - Tusken Raider
  Feedback & reporting bugs: galnaraven@gmail.com
  Credits to ArMaTeC for the LHD spawning script.
  Credits to General Carver for the fixed wing rearming script.
**********************************************************************************************************************************
**********************************************************************************************************************************
__________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________


***Basic info***
This scrip simulates arresting gear landings for aircrafts when landing on any aircraft carrier.
The script works on any carrier or anywhere. Just make sure you adjust the cables to the correct position above sea level.
It also works if the carrier is moving, as long as the "cables" object move along with it.
You can choose if you only want to be able to land from both directions or just one.
Any player in a plane who touches down gets hooked and braked.
After the plane has been braked and pushed back a bit, just take off and repeat.

I have made it easy to modify the cable area size and the brakeing sequence in the script file.
____________________________________________________________________________________________________________________


***Install***
To play the testmission:
Unzip "Arrestinggear_Test.utes" folder into /My documents/Arma 2 Other profiles/*PLAYER NAME*/Missions
Load in editor.

____________________________________________________________________________________________________________________


***To Use script in your mission***
Unzip Arrestinggear.sqf to your missionfolder.

To iniziate the script put this line in your init.sqf or in any initfield:

call {[] execVM "Arrestinggear.sqf";};
-------------------------------------

Place an object on the map named "cables" where you want the center of the cables to be.

A invisible H helipad is recommended, but you can put whatever on the ocean floor if you like.
Put this preferably in the middle of the carrier runway. But if you only want one way landing you may put it on only either side.

**IMPORTANT!**
The object needs to have the same azimut/direction as the carrier so the cables are going across the runway.
If you change direction of the carrier change it for this object as well.
To hook on to the cables the plane cannot deviate more than 30 degrees from the objects direction.
The same goes for when landing in the opposite direction. 

-------------------------------------

(Optional) 
To use the custom landing sound:	UNzip the "Sounds" folder to your missionfolder.
					Copy and paste everything in the description.ext into your own description.ext.
					Open Arrestinggear.sqf in notepad and find the variable _sound.
					Set
					_sound=0; 
					to 
					_sound=1;
					It is the top variable among the editedble variables.

-------------------------------------

(Optional)
To enable onlu one direction landing:	Open Arrestinggear.sqf in notepad and find the variable _bothwaylanding.
					Set
					_bothwaylanding=1;
					to
					_bothwaylanding=0;
					Now you can only land when comming in from behind the "cables" object.
					In other words you can only hook on the plane has the same azimut +-30 degrees as the "cables" object.

-------------------------------------

Now you are good to go!

__________________________________________________________________________________________________________________________________

**Detailed info**

This script is always running clientside.

If you create a carrier make sure you check so the cables hook on at the right position above sea level.
This may vary.

When landing you need to be very close above or touchdown on the runway.
The brakeing procedure is ongoing after touchdown until the "bounceback". You cannot abort if the plane is hooked!

You know you have hooked on to the cables if you slow down to a halt on the carrier, then a quick bounceback.
The stop is not down to 0 instantly as when you get stuck into something. Like the front wheel touching the carrier first.
I didn't put in any cheesy radiomessages to let you know you are hooked. If you want it, just add it in the if (hooked) syntax.

It is possible to land at any speed.

It is possible to land whithout the plane getting damaged. Touchdown with the back wheels first! (And be aware of arma physics.)

It is possible to land any plane on the carrier as long as it is isKindOf "plane". Although some of you may be aware that some 
airplane wheels bug out when landing on a "created" carrier.

In the test mission i added a radiotrigger (0-0-1) where you can see how big the cable area will be.

Don't go looking for a hook and cables because there aren't any. ;)

You are free to modifly, delete, manipulate and distribute the script in whatever way you want.



Enjoy!



**********************************************************************************************************************************
**********************************************************************************************************************************
__________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________